ナレッジベース管理
このページでは、AIエージェントが回答を生成する際に参照するドキュメント（ナレッジ）の登録・管理と、AIへの反映（同期）を行います。
1. ドキュメントを追加する
画面左の「ドキュメント追加」エリアから、新しいドキュメントをアップロードします。
- アップロードエリアをクリックしてファイルを選択するか、ファイルをドラッグ＆ドロップします。
- ファイルを選択すると入力欄が表示されるので、以下の情報を入力します。
項目 必須 説明 ファイル ○ PDF / Word (DOCX) / TXT / CSV / MD / HTML 形式に対応しています。
サイズ上限: PDF 20MB / Word 5MB / テキスト系 1MB</strong >。
対応外の形式の場合はエラーが表示されます。ファイル説明 ○ このファイルの内容・用途を説明するメモです（200文字以内）。 タグ ○ ドキュメントを分類するタグです（1件以上必須</strong >・最大10件・各タグ20文字以内）。
既存のタグが入力候補として表示され、AIの検索対象を絞り込むために使われます。 - 「アップロード」ボタンをクリックして登録します。
ファイル説明・タグが未入力の間は、アップロードボタンは押せません。
アップロード後は、ファイルの解析がバックグラウンドで実行されます。一覧の状態が「解析中」と表示され、完了すると自動的に「未同期」へ変わります（画面を開いたまま完了を待てます）。
NOTE
登録済みと同名のファイルをアップロードしようとすると、「「ファイル名」は既に登録されています。上書きしますか？」という確認ダイアログが表示されます。OKするとファイル内容・説明・タグが今回の入力で置き換わります。
なお、拡張子だけが異なる同名ファイルが既に存在する場合や、同名ファイルが解析中の場合はアップロードできません（先に既存ファイルを削除してください）。
また、アップロードした原本ファイルはそのまま保存され、一覧の「ダウンロード」からいつでも取得できます。
エージェント参照用のデータは自動で分析・登録されます（処理に時間がかかる場合があります）。
CAUTION
ファイルの変換（分析）には生成AI（Gemini）を利用するため、アップロードには「外部連携設定」で Gemini の API キーが登録されている必要があります。
未登録の場合は「Gemini連携が登録されていません」というエラーになります。 </strong >
Tips
ファイル説明・タグは、AIエージェントノードでナレッジファイルを選ぶ際の手掛かりになるほか、AIの内容理解・検索精度にも影響します。内容が分かりやすい説明・タグを設定してください。
あとから編集することもできます（後述の「4. ファイル情報（説明・タグ）を編集する」参照）。
2. 登録済みドキュメントを確認する
画面右の「登録済みドキュメント」テーブルに、アップロード済みのドキュメントが一覧で表示されます。
| 項目 | 説明 |
| ファイル名 | ドキュメントのファイル名です。設定済みのファイル説明とタグもあわせて表示されます。 |
| 状態 | AIへの反映状況を表すバッジです（下表参照）。 |
| サイズ | ファイルサイズ（KB）です。 |
| 更新日時 | ファイルが最後にアップロード・更新された日時です。 |
| 操作 | ダウンロード（アップロードした原本ファイルの取得）、編集（ファイル説明・タグの変更）、削除を行うアイコンが表示されます。 解析中・解析失敗のドキュメントは編集できません（解析中は削除もできません）。 |
状態バッジの見かた
| 状態 | 意味 |
| 同期済み（緑） | 最後の同期以降に変更がなく、AIに反映されている状態です。 |
| 未同期（黄） | 最後の同期よりあとにアップロード・更新されたため、まだAIに反映されていない状態です。 |
| 同期中（青） | 同期処理を実行中です。完了すると自動的に表示が更新されます。 |
| 解析中（紫） | アップロードしたファイルをバックグラウンドで解析しています。完了すると自動的に「未同期」へ変わります。 解析中は編集・削除・同期ができません。 |
| 解析失敗（赤） | ファイルの解析に失敗した状態です（サイズ超過・内容の読み取り不可など）。バッジにカーソルを合わせると失敗理由が表示されます。 削除して、原因を解消したうえで再アップロードしてください。 |
Tips
未同期の変更（ファイルの追加・編集・削除）がある場合は、ページ上部に「注意: 未同期の変更があります」という注意バナーが表示されます。
また、解析中のファイルがある間は「解析中のファイルがあります」というバナーが表示されます。
3. ナレッジを同期する（AIへの反映）
ドキュメントのアップロード・編集・削除を行っただけでは、AIの回答にはまだ反映されません。
画面右上の「ナレッジを同期する」ボタンをクリックして、同期処理を実行してください。
- 同期を開始すると、ボタンと各ドキュメントの状態が「同期中」表示に変わります。AIへの反映には数分かかる場合があります。
- 同期状況は自動的に更新されるため、画面を開いたまま完了を待てます。
- 解析中のファイルがある間は同期を実行できません。解析の完了を待ってから実行してください。
CAUTION
アップロード・編集・削除・差し替えのあとは、必ず「ナレッジを同期する」を実行してください。
同期するまで、AIエージェントは変更前のナレッジをもとに回答します。
NOTE
未同期の変更が何もない場合、「ナレッジを同期する」ボタンは無効化されます。
ドキュメントを全件削除した場合も「未同期の変更」となるため、同期を実行して削除をAIに反映してください。
4. ファイル情報（説明・タグ）を編集する
登録済みドキュメントのファイル説明とタグは、あとから変更できます。
- 対象ドキュメントの操作列にある「編集（ペンアイコン）」をクリックします。
- 編集ダイアログでファイル説明（200文字以内・必須）・タグ（1件以上必須・最大10件）を修正します。
- 「保存」ボタンをクリックして反映します（説明が空、またはタグが0件の間は保存できません）。
NOTE
ファイル説明・タグの変更も「未同期の変更」として扱われます。変更後は「ナレッジを同期する」を実行すると検索に反映されます。
ファイルの内容自体を差し替えたい場合は、同名ファイルを再アップロード（上書き確認あり）してから同期してください。
なお、解析中・解析失敗のドキュメントは編集できません。
5. ドキュメントを削除する
不要になったドキュメントを削除します。
- 対象ドキュメントの操作列にある「削除（ゴミ箱アイコン）」をクリックします。
- 確認ダイアログが表示されるので、内容を確認して削除を確定します。
CAUTION
削除したドキュメントは復元できません。
また、削除後も「ナレッジを同期する」を実行するまでは、AIの回答に削除前の内容が使われることがあります。
削除後は同期を実行してください。なお、同期処理の実行中と解析中は削除ボタンが無効化されます。
6. タグで絞り込む
登録済みドキュメントの一覧は、タグで絞り込んで表示できます。
- 一覧右上の「タグで絞り込む」ボタンをクリックし、表示されたリストからタグを選択します。タグ名の検索も可能です。
- 複数のタグを選択した場合は OR 検索となり、選択したタグのいずれかを含むドキュメントが表示されます（該当件数はフィルタの下に表示されます）。
- 「クリア」ボタンで絞り込みを解除できます。
NOTE
タグの変更（付け替え・名称変更）は、各ドキュメントの編集ダイアログから行います。
※以前あった「タグ管理」ボタン（タグの一括リネーム・一括削除）は廃止されました。
7. 原本ファイルをダウンロードする
アップロードした原本ファイルは、そのまま保存されており、いつでもダウンロードできます。
- 対象ドキュメントの操作列にある「ダウンロード（下矢印アイコン）」をクリックします。
- アップロード時の原本ファイルがそのままダウンロードされます。
8. ナレッジの活用先
ここで登録・同期したドキュメントは、シナリオの「AIエージェント」ノードの「ナレッジファイル」設定で選択でき、通話中にAIが回答の根拠として参照します。
詳細はノード設定マニュアルの「AIエージェント」の章を参照してください。
